πŸ“š 4. μ—”ν‹°ν‹° λ§€ν•‘

@Seongukbaek Posted March 11, 2022 Β· Updated March 11, 2022 Β· 22 min read

[μžλ°” ORM ν‘œμ€€ JPA ν”„λ‘œκ·Έλž˜λ° - κΉ€μ˜ν•œ]을 읽고 μΈμš©ν•˜κ³  μ •λ¦¬ν•˜λŠ” POSTμž…λ‹ˆλ‹€.

JPAλ₯Ό μ‚¬μš©ν•˜λŠ” 데 κ°€μž₯ μ€‘μš”ν•œ 일은 "엔티티와 ν…Œμ΄λΈ”μ„ μ •ν™•νžˆ λ§€ν•‘ν•˜λŠ” 것"이닀. 이λ₯Ό μœ„ν•΄μ„œλŠ” λ§€ν•‘ annotation을 μˆ™μ§€ν•˜κ³  μ‚¬μš©ν•΄μ•Ό ν•œλ‹€. μ•„λž˜λŠ” λŒ€ν‘œ annotation듀이닀.

  • 객체와 ν…Œμ΄λΈ” λ§€ν•‘ : @Entity , @Table
  • κΈ°λ³Έ ν‚€ λ§€ν•‘ : @Id
  • ν•„λ“œμ™€ 컬럼 λ§€ν•‘ : @Column
  • 연관관계 λ§€ν•‘ : @ManyToOne , @JoinColumn

πŸ’« @Entity

JPAλ₯Ό μ‚¬μš©ν•΄ ν…Œμ΄λΈ”κ³Ό λ§€ν•‘ν•  ν΄λž˜μŠ€λŠ” ν•΄λ‹Ή annotation을 ν•„μˆ˜λ‘œ λΆ™μ—¬μ•Ό ν•œλ‹€. 이 annotation이 뢙은 ν΄λž˜μŠ€λŠ” JPAκ°€ κ΄€λ¦¬ν•˜λŠ” κ²ƒμœΌλ‘œ, 엔티티라 λΆ€λ₯Έλ‹€.

속성 정리

  • name

    • JPAμ—μ„œ μ‚¬μš©ν•  μ—”ν‹°ν‹° 이름을 μ§€μ •ν•œλ‹€. 보톡 기본값인 클래슀 이름을 μ‚¬μš©ν•œλ‹€.

@Entity 적용 μ‹œ μ•„λž˜μ™€ 같은 μ£Όμ˜μ‚¬ν•­μ΄ μžˆλ‹€.

  • κΈ°λ³Έ μƒμ„±μžλŠ” ν•„μˆ˜λ‹€(νŒŒλΌλ―Έν„°κ°€ μ—†λŠ” public λ˜λŠ” protected μƒμ„±μž)

    • JPAκ°€ μ—”ν‹°ν‹° 객체λ₯Ό 생성할 λ•Œ κΈ°λ³Έ μƒμ„±μžλ₯Ό μ‚¬μš©ν•˜κΈ° λ•Œλ¬Έμ΄λ‹€.
  • final 클래슀, enum, interface, inner ν΄λž˜μŠ€μ—λŠ” μ‚¬μš©ν•  수 μ—†λ‹€.
  • μ €μž₯ν•  ν•„λ“œμ— final 을 μ‚¬μš©ν•˜λ©΄ μ•ˆλœλ‹€.

μžλ°”λŠ” μƒμ„±μžκ°€ ν•˜λ‚˜λ„ μ—†μœΌλ©΄ κΈ°λ³Έ μƒμ„±μžλ₯Ό μžλ™μœΌλ‘œ μƒμ„±ν•œλ‹€. λ¬Έμ œλŠ” μƒμ„±μžλ₯Ό ν•˜λ‚˜ 이상 λ§Œλ“€ 경우 μžλ°”λŠ” κΈ°λ³Έ μƒμ„±μžλ₯Ό μžλ™μœΌλ‘œ μƒμ„±ν•˜μ§€ μ•ŠλŠ”λ‹€. λ”°λΌμ„œ κΈ°λ³Έ μƒμ„±μžλ₯Ό 직접 λ§Œλ“€μ–΄μ•Ό ν•œλ‹€.

public Member() {} // κΈ°λ³Έ μƒμ„±μž public Member(String name) { // μž„μ˜μ˜ μƒμ„±μž this.name = name; }

πŸ’« @Table

엔티티와 λ§€ν•‘ν•  ν…Œμ΄λΈ”μ„ μ§€μ •ν•˜λŠ” annotation으둜 μƒλž΅ν•˜λŠ” 경우 λ§€ν•‘ν•œ μ—”ν‹°ν‹° 이름을 ν…Œμ΄λΈ” μ΄λ¦„μœΌλ‘œ μ‚¬μš©ν•œλ‹€.

속성 정리

  • name

    • λ§€ν•‘ν•  ν…Œμ΄λΈ” μ΄λ¦„μœΌλ‘œ, 기본값은 μ—”ν‹°ν‹° 이름이닀.
  • catalog

    • catalog κΈ°λŠ₯이 μžˆλŠ” λ°μ΄ν„°λ² μ΄μŠ€μ—μ„œ catalogλ₯Ό λ§€ν•‘ν•œλ‹€.
    • catalog: λ°μ΄ν„°λ² μ΄μŠ€μ˜ κ°œμ²΄λ“€μ— λŒ€ν•œ μ •μ˜λ₯Ό λ‹΄κ³  μžˆλŠ” μΌμ’…μ˜ λ©”νƒ€λ°μ΄ν„°λ“€λ‘œ κ΅¬μ„±λœ μΈμŠ€ν„΄μŠ€
  • schema

    • schema κΈ°λŠ₯이 μžˆλŠ” λ°μ΄ν„°λ² μ΄μŠ€μ—μ„œ schemaλ₯Ό λ§€ν•‘ν•œλ‹€.
  • uniqueConstraints(DDL)

    • DDL 생성 μ‹œ μœ λ‹ˆν¬ μ œμ•½ 쑰건을 λ§Œλ“ λ‹€. 2개 μ΄μƒμ˜ 볡합 μœ λ‹ˆν¬ μ œμ•½μ‘°κ±΄λ„ κ°€λŠ₯ν•˜λ‹€.
    • μŠ€ν‚€λ§ˆ μžλ™ 생성 κΈ°λŠ₯을 μ‚¬μš©ν•΄μ„œ DDL을 λ§Œλ“€ λ•Œλ§Œ μ‚¬μš©λœλ‹€.

πŸ’« λ‹€μ–‘ν•œ λ§€ν•‘ μ‚¬μš©

이전 μž₯μ—μ„œ κ°œλ°œν•˜λ˜ νšŒμ› 관리 ν”„λ‘œκ·Έλž¨μ— λ‹€μŒ μš”κ΅¬μ‚¬ν•­μ΄ μΆ”κ°€λ˜μ—ˆλ‹€.

  1. νšŒμ›μ€ 일반 νšŒμ›κ³Ό κ΄€λ¦¬μžλ‘œ ꡬ뢄해야 ν•œλ‹€.
  2. νšŒμ› κ°€μž…μΌκ³Ό μˆ˜μ •μΌμ΄ μžˆμ–΄μ•Ό ν•œλ‹€.
  3. νšŒμ›μ„ μ„€λͺ…ν•  수 μžˆλŠ” ν•„λ“œκ°€ μžˆμ–΄μ•Ό ν•œλ‹€. 이 ν•„λ“œλŠ” 길이 μ œν•œμ΄ μ—†λ‹€.

κΈ°λŠ₯ κ΅¬ν˜„μ„ μœ„ν•΄ νšŒμ› μ—”ν‹°ν‹° μ½”λ“œλ₯Ό μΆ”κ°€ν•œλ‹€.

@Entity @Table(name="MEMBER") public class Member { ... @Enumerated(EnumType.STRING) private RoleType roleType; @Temporal(TemporalType.TIMESTAMP) private Date createdDate; @Temporal(TemporalType.TIMESTAMP) private Date lastModifiedDate; @Lob private String description; ... }

μœ„ μ½”λ“œλ₯Ό 뢄석해보면,

  • roleType : μžλ°”μ˜ enum 을 μ‚¬μš©ν•΄ νšŒμ›μ˜ νƒ€μž…μ„ κ΅¬λΆ„ν–ˆλ‹€.

    • 이처럼 enum 을 μ‚¬μš©ν•˜λ €λ©΄ @Enumerated annotation으둜 λ§€ν•‘ν•΄μ•Ό ν•œλ‹€.
  • createdDate , lastModifiedDate : μžλ°”μ˜ λ‚ μ§œ νƒ€μž…μ€ @Temporal 을 μ‚¬μš©ν•΄μ„œ λ§€ν•‘ν•œλ‹€.
  • description : νšŒμ›μ„ μ„€λͺ…ν•˜λŠ” ν•„λ“œλ‘œμ„œ 길이 μ œν•œμ΄ μ—†μ–΄μ•Ό ν•œλ‹€. λ”°λΌμ„œ λ°μ΄ν„°λ² μ΄μŠ€μ˜ VARCHAR νƒ€μž… λŒ€μ‹  CLOB νƒ€μž…μœΌλ‘œ μ €μž₯ν•΄μ•Ό ν•œλ‹€.

πŸ’« λ°μ΄ν„°λ² μ΄μŠ€ μŠ€ν‚€λ§ˆ μžλ™ 생성

JPAλŠ” λ°μ΄ν„°λ² μ΄μŠ€ μŠ€ν‚€λ§ˆλ₯Ό μžλ™μœΌλ‘œ μƒμ„±ν•˜λŠ” κΈ°λŠ₯이 μžˆλ‹€. 클래슀의 λ§€ν•‘ 정보λ₯Ό 보고 μ–΄λ–€ ν…Œμ΄λΈ”μ— μ–΄λ–€ μ»¬λŸΌμ„ μ‚¬μš©ν•˜λŠ”μ§€ μ•Œ 수 μžˆμ–΄ 이λ₯Ό 톡해 λ°μ΄ν„°λ² μ΄μŠ€ μŠ€ν‚€λ§ˆλ₯Ό μƒμ„±ν•œλ‹€.

λ¨Όμ € persistence.xml 에 속성을 μΆ”κ°€ν•˜μ—¬ μ• ν”Œλ¦¬μΌ€μ΄μ…˜ μ‹€ν–‰ μ‹œμ μ— λ°μ΄ν„°λ² μ΄μŠ€ ν…Œμ΄λΈ”μ„ μžλ™μœΌλ‘œ μƒμ„±ν•˜λ„λ‘ ν•œλ‹€.

<property name="hibernate.hbm2ddl.auto" value="create" />

show_sql μ†μ„±μœΌλ‘œ μ‹€ν–‰ κ²°κ³Όλ₯Ό 보면, κΈ°μ‘΄ ν…Œμ΄λΈ”μ„ μ‚­μ œν•˜κ³  μƒˆλ‘œ μƒμ„±ν•˜λŠ” 것을 확인할 수 있고, μ•„λž˜μ™€ 같이 λ§€ν•‘λ˜μ–΄ μƒμ„±λ˜λŠ” 것을 확인할 수 μžˆλ‹€.

  • roleType β†’ VARCHAR , createdDate , lastModifiedDate β†’ TIMESTAMP , description β†’ CLOB νƒ€μž…

μžλ™ μƒμ„±λ˜λŠ” DDL은 μ§€μ •ν•œ λ°μ΄ν„°λ² μ΄μŠ€ 방언에 따라 달라진닀.

이 κΈ°λŠ₯을 μ‚¬μš©ν•΄ κ°œλ°œμžκ°€ ν…Œμ΄λΈ”μ„ 직접 μƒμ„±ν•˜λŠ” 수고λ₯Ό λœμ—ˆλ‹€. ν•˜μ§€λ§Œ 이 DDL이 μ™„λ²½ν•œ 것은 μ•„λ‹ˆκΈ°μ— μ°Έκ³ ν•˜λŠ” μ •λ„λ‘œλ§Œ μ‚¬μš©ν•˜λŠ” 것이 μ’‹λ‹€.

hibernate.hbm2ddl.auto 속성 정리

  • create : κΈ°μ‘΄ ν…Œμ΄λΈ” μ‚­μ œ + μƒˆλ‘œ 생성 (DROP + CREATE)
  • create-drop : create 속성에 μΆ”κ°€λ‘œ μ• ν”Œλ¦¬μΌ€μ΄μ…˜ μ’…λ£Œ μ‹œ μƒμ„±ν•œ DDL을 제거 (DROP + CREATE + DROP)
  • update : λ°μ΄ν„°λ² μ΄μŠ€ ν…Œμ΄λΈ”κ³Ό μ—”ν‹°ν‹° λ§€ν•‘ 정보λ₯Ό 비ꡐ해 λ³€κ²½ μ‚¬ν•­λ§Œ μˆ˜μ • (JPA 2.1λΆ€ν„°λŠ” 지원 X)
  • validate : λ°μ΄ν„°λ² μ΄μŠ€ ν…Œμ΄λΈ”κ³Ό μ—”ν‹°ν‹° λ§€ν•‘ 정보λ₯Ό 비ꡐ해 차이가 있으면 κ²½κ³ λ₯Ό 남기고 μ‹€ν–‰ν•˜μ§€ μ•ŠμŒ (DDL을 μˆ˜μ •ν•˜μ§€ μ•ŠλŠ” μ„€μ •, JPA 2.1λΆ€ν„°λŠ” 지원 X)
  • none : μžλ™ 생성 κΈ°λŠ₯을 μ‚¬μš©ν•˜μ§€ μ•ŠμŒ

πŸ’« DDL 생성 κΈ°λŠ₯

νšŒμ› 이름은 ν•„μˆ˜ μž…λ ₯ 값이고, 10자λ₯Ό μ΄ˆκ³Όν•˜λ©΄ μ•ˆλœλ‹€λŠ” μ œμ•½μ‘°κ±΄μ΄ μΆ”κ°€λ˜μ—ˆλ‹€. μŠ€ν‚€λ§ˆ μžλ™ 생성을 톡해 λ§Œλ“€μ–΄μ§€λŠ” DDL에 이 μ œμ•½μ‘°κ±΄μ„ μΆ”κ°€ν•œλ‹€.

@Column(name = "NAME", nullable = false, length = 10) private String username;
  • @Column 의 nullable 속성 κ°’μœΌλ‘œ μžλ™ μƒμ„±λ˜λŠ” DDL에 not null μ œμ•½μ‘°κ±΄μ„ μΆ”κ°€ν•  수 μžˆλ‹€.
  • λ˜ν•œ, length 속성 κ°’μœΌλ‘œ 문자의 크기도 μ§€μ •ν•  수 μžˆλ‹€.

μ΄λ²ˆμ—λŠ” μœ λ‹ˆν¬ μ œμ•½μ‘°κ±΄μ„ λ§Œλ“€μ–΄ μ£ΌλŠ” @Table 의 uniqueConstraints 속성을 μ‚¬μš©ν•΄λ³Έλ‹€.

@Entity @Table(name="MEMBER", uniqueConstraints = {@UniqueConstraint( name = "NAME_AGE_UNIQUE", columnNames = {"NAME", "AGE"})}) public class Member { ... }

μœ„μ˜ 속성듀은 단지 DDL μžλ™ 생성 μ‹œμ—λ§Œ μ‚¬μš©λ˜κ³  JPA의 μ‹€ν–‰ λ‘œμ§μ—λŠ” 영ν–₯을 μ£Όμ§€ μ•ŠλŠ”λ‹€.


πŸ’« κΈ°λ³Έ ν‚€ λ§€ν•‘

μ§€κΈˆκΉŒμ§€λŠ” @Id annotation만 μ‚¬μš©ν•΄ νšŒμ›μ˜ κΈ°λ³Έ ν‚€λ₯Ό μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ—μ„œ 직접 ν• λ‹Ήν–ˆλ‹€.

  • κΈ°λ³Έ ν‚€λ₯Ό μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ—μ„œ 직접 ν• λ‹Ήν•˜λŠ” 방식이 μ•„λ‹Œ λ°μ΄ν„°λ² μ΄μŠ€κ°€ μƒμ„±ν•΄μ£ΌλŠ” κ°’μœΌλ‘œ μ‚¬μš©ν•˜λ €λ©΄ μ–΄λ–»κ²Œ λ§€ν•‘ν•΄μ•Ό ν• κΉŒ?

    • MySQL의 AUTO_INCREMENT 같은 κΈ°λŠ₯
  • λ°μ΄ν„°λ² μ΄μŠ€λ§ˆλ‹€ κΈ°λ³Έ ν‚€λ₯Ό μƒμ„±ν•˜λŠ” 방식이 달라 ν•΄κ²°ν•˜κΈ°λŠ” 쉽지 μ•Šλ‹€.

JPAλŠ” λ°μ΄ν„°λ² μ΄μŠ€ κΈ°λ³Έ ν‚€ 생성 μ „λž΅μ΄ λ‹€μŒκ³Ό κ°™λ‹€.

  • 직접 ν• λ‹Ή : κΈ°λ³Έ ν‚€λ₯Ό μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ—μ„œ 직접 ν• λ‹Ήν•œλ‹€.
  • μžλ™ 생성 : λŒ€λ¦¬ ν‚€ μ‚¬μš© 방식

    • IDENTITY : κΈ°λ³Έ ν‚€ 생성을 λ°μ΄ν„°λ² μ΄μŠ€μ— μœ„μž„ν•œλ‹€.
    • SEQUENCE : λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€λ₯Ό μ‚¬μš©ν•΄ κΈ°λ³Έ ν‚€λ₯Ό ν• λ‹Ήν•œλ‹€.
    • TABLE : ν‚€ 생성 ν…Œμ΄λΈ”μ„ μ‚¬μš©ν•œλ‹€.

μžλ™ 생성 μ „λž΅μ΄ λ‹€μ–‘ν•œ μ΄μœ λŠ” λ°μ΄ν„°λ² μ΄μŠ€λ§ˆλ‹€ 지원 방식이 μ„œλ‘œ λ‹€λ₯΄κΈ° λ•Œλ¬Έμ΄λ‹€. SEQUENCEλ‚˜ IDENTITY 방식은 μ‚¬μš©ν•˜λŠ” λ°μ΄ν„°λ² μ΄μŠ€μ— μ˜μ‘΄ν•˜κ³ , TABLE 방식은 ν…Œμ΄λΈ”μ„ ν™œμš©ν•˜κΈ°μ— λͺ¨λ“  λ°μ΄ν„°λ² μ΄μŠ€μ—μ„œ μ‚¬μš©ν•  수 μžˆλ‹€.

μžλ™ 생성 μ „λž΅μ„ μ‚¬μš©ν•˜κΈ° μœ„ν•΄μ„œλŠ” @Id 에 @GeneratedValue λ₯Ό μΆ”κ°€ν•˜κ³  μ›ν•˜λŠ” 생성 μ „λž΅μ„ μ„ νƒν•˜λ©΄ λœλ‹€.

ν‚€ 생성 μ „λž΅ μ‚¬μš© μ‹œ hibernate.id.new_generator_mappings=true 속성이 ν•„μˆ˜μ μ΄λ‹€.

➰ κΈ°λ³Έ ν‚€ 직접 ν• λ‹Ή μ „λž΅

@Id 둜 λ§€ν•‘ν•˜λ©΄ 되고, 적용 κ°€λŠ₯ν•œ μžλ°” νƒ€μž…μ€ λ‹€μŒκ³Ό κ°™λ‹€.

  • μžλ°” κΈ°λ³Έν˜•
  • μžλ°” Wrapperν˜•
  • String
  • java.util.Date
  • java.sql.Date
  • java.math.BigDecimal
  • java.math.BigInteger

이 μ „λž΅μ€ em.persist() 둜 μ—”ν‹°ν‹°λ₯Ό μ €μž₯ν•˜κΈ° 전에 μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ—μ„œ κΈ°λ³Έ ν‚€λ₯Ό 직접 ν• λ‹Ήν•˜λŠ” 방법이닀.

Board board = new Board(); board.setId("id1"); em.persist(board);

이 μ „λž΅μ—μ„œ μ‹λ³„μž κ°’ 없이 μ €μž₯ν•˜λ©΄ μ˜ˆμ™Έκ°€ λ°œμƒν•œλ‹€. JPA ν‘œμ€€μ— μ •μ˜λ˜μ–΄ μžˆμ§„ μ•Šμ§€λ§Œ hibernateλ₯Ό κ΅¬ν˜„μ²΄λ‘œ μ‚¬μš©ν•˜λ©΄ JPA μ΅œμƒμœ„ μ˜ˆμ™ΈμΈ javax.persistence.PersistenceException 이 λ°œμƒν•˜κ³  μ΄λŠ” 내뢀에 hibernate μ˜ˆμ™ΈμΈ org.hibernate.id.IdentifierGenerationException 을 ν¬ν•¨ν•˜κ³  μžˆλ‹€.

➰ IDENTITY μ „λž΅

κΈ°λ³Έ ν‚€ 생성을 λ°μ΄ν„°λ² μ΄μŠ€μ— μœ„μž„ν•˜λŠ” μ „λž΅μ΄λ‹€. 주둜 MySQL, PostgreSQL, SQL Server, DB2μ—μ„œ μ‚¬μš©λœλ‹€. 예λ₯Ό λ“€μ–΄ MySQL의 AUTO_INCREMENT κΈ°λŠ₯을 μˆ˜ν–‰ν•˜λŠ” 예제λ₯Ό 보면,

CREATE TABLE BOARD ( ID INT NOT NULL AUTO_INCREMENT PRIMARY KEY, DATA VARCHAR(255) ); INSERT INTO BOARD(DATA) VALUES('A'); INSERT INTO BOARD(DATA) VALUES('B');
  • ν…Œμ΄λΈ” 생성 μ‹œ κΈ°λ³Έ ν‚€ μ»¬λŸΌμ— AUTO_INCREMENT λ₯Ό μΆ”κ°€ν•΄ λ°μ΄ν„°λ² μ΄μŠ€μ— 값을 μ €μž₯ν•  λ•Œ ID μ»¬λŸΌμ„ λΉ„μ›Œλ‘λ©΄ μžλ™μœΌλ‘œ μˆœμ„œλŒ€λ‘œ 값을 μ±„μ›Œμ€€λ‹€.

IDENTITY μ „λž΅μ€ 이처럼 "λ°μ΄ν„°λ² μ΄μŠ€μ— 값을 μ €μž₯ν•˜κ³  λ‚˜μ„œμ•Ό κΈ°λ³Έ ν‚€ 값을 ꡬ할 수 μžˆμ„ λ•Œ" μ‚¬μš©ν•œλ‹€.

κ°œλ°œμžκ°€ 엔티티에 직접 μ‹λ³„μžλ₯Ό ν• λ‹Ήν•˜λ©΄ @Id annotation만 있으면 λ˜μ§€λ§Œ μ§€κΈˆμ²˜λŸΌ μƒμ„±λ˜λŠ” κ²½μš°μ—λŠ” @GeneratedValue annotation을 μ‚¬μš©ν•΄ μ‹λ³„μž 생성 μ „λž΅μ„ 선택해야 ν•œλ‹€.

  • μ΄λ•Œ JPAλŠ” κΈ°λ³Έ ν‚€ 값을 μ–»μ–΄μ˜€κΈ° μœ„ν•΄ λ°μ΄ν„°λ² μ΄μŠ€λ₯Ό μΆ”κ°€λ‘œ μ‘°νšŒν•œλ‹€.
@Id @GeneratedValue(strategy = GenerationType.IDENTITY) @Column(name = "ID") private Long id;

ν•΄λ‹Ή μ „λž΅μ€ λ°μ΄ν„°λ² μ΄μŠ€μ— INSERTν•œ 후에 κΈ°λ³Έ ν‚€ 값을 μ‘°νšŒν•  수 μžˆλ‹€. λ”°λΌμ„œ 엔티티에 μ‹λ³„μž 값을 ν• λ‹Ήν•˜κΈ° μœ„ν•΄μ„œλŠ” 좔가적인 μ‘°νšŒκ°€ ν•„μš”ν–ˆλ‹€. JDBC3에 μΆ”κ°€λœ Statement.getGeneratedKeys() λ₯Ό μ‚¬μš©ν•˜λ©΄ 데이터 μ €μž₯κ³Ό λ™μ‹œμ— μƒμ„±λœ κΈ°λ³Έ ν‚€ 값도 μ–»μ–΄μ˜¬ 수 μžˆλ‹€. hibernateλŠ” 이 λ©”μ†Œλ“œλ₯Ό μ‚¬μš©ν•΄ λ°μ΄ν„°λ² μ΄μŠ€μ™€ ν•œ 번만 ν†΅μ‹ ν•œλ‹€.

μ—”ν‹°ν‹°κ°€ μ˜μ† μƒνƒœκ°€ 되렀면 μ‹λ³„μžκ°€ λ°˜λ“œμ‹œ ν•„μš”ν•˜λ‹€. ν•˜μ§€λ§Œ 이 μ „λž΅μ€ λ°μ΄ν„°λ² μ΄μŠ€μ— μ—”ν‹°ν‹°λ₯Ό μ €μž₯ν•΄μ•Ό μ‹λ³„μžλ₯Ό ꡬ할 수 μžˆμ–΄ νŠΈλžœμž­μ…˜μ„ μ§€μ›ν•˜λŠ” μ“°κΈ° 지연이 λ™μž‘ν•˜μ§€ μ•ŠλŠ”λ‹€.

➰ SEQUENCE μ „λž΅

λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€λŠ” μœ μΌν•œ 값을 μˆœμ„œλŒ€λ‘œ μƒμ„±ν•˜λŠ” νŠΉλ³„ν•œ λ°μ΄ν„°λ² μ΄μŠ€ μ˜€λΈŒμ νŠΈλ‹€. SEQUENCE μ „λž΅μ€ μ‹œν€ΈμŠ€λ₯Ό μ‚¬μš©ν•΄ κΈ°λ³Έ ν‚€λ₯Ό μƒμ„±ν•œλ‹€. λ‹Ήμ—°νžˆ μ‹œν€ΈμŠ€λ₯Ό μ§€μ›ν•˜λŠ” 였라클, PostgreSQL, DB2, H2 λ°μ΄ν„°λ² μ΄μŠ€μ—μ„œλ§Œ μ‚¬μš©ν•  수 μžˆλ‹€.

CREATE TABLE BOARD ( ID BIGINT NOT NULL PRIMARY KEY, DATA VARCHAR(255) ) -- μ‹œν€ΈμŠ€ 생성 CREATE SEQUENCE BOARD_SEQ START WITH 1 INCREMENT BY 1;
  • μ‹œν€ΈμŠ€μ˜ μ‚¬μš©μ„ μœ„ν•΄μ„œλŠ” μ‹œν€ΈμŠ€λ₯Ό 생성해야 ν•œλ‹€.
@Entity @SequenceGenerator( name="BOARD_SEQ_GENERATOR", sequenceName = "BOARD_SEQ", // λ§€ν•‘ν•  λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€ 이름 initialValue = 1, allocationSize = 1) public class Member { @Id @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "BOARD_SEQ_GENERATOR") private Long id; ... }
  • 이후 μ‚¬μš©ν•  λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€λ₯Ό λ§€ν•‘ν•΄μ•Ό ν•œλ‹€. μœ„ μ˜ˆμ œμ—μ„œλŠ” @SequenceGenerator λ₯Ό μ‚¬μš©ν•΄ BOARD_SEQ_GENERATOR λΌλŠ” μ‹œν€ΈμŠ€ 생성기λ₯Ό λ“±λ‘ν–ˆλ‹€.
  • sequenceName μ†μ„±μ˜ μ΄λ¦„μœΌλ‘œ BOARD_SEQ λ₯Ό μ§€μ •ν•˜μ—¬ JPAκ°€ 이 μ‹œν€ΈμŠ€ 생성기λ₯Ό μ‹€μ œ λ°μ΄ν„°λ² μ΄μŠ€μ˜ BOARD_SEQ μ‹œν€ΈμŠ€μ™€ λ§€ν•‘ν•˜λ„λ‘ ν•œλ‹€.
  • ν‚€ 생성 μ „λž΅μ„ μ„€μ •ν•˜κ³  생성기λ₯Ό λ“±λ‘ν•œ μ‹œν€ΈμŠ€ μƒμ„±κΈ°λ‘œ μ„ νƒν•˜μ—¬ id μ‹λ³„μž 값은 BOARD_SEQ_GENERATOR μ‹œν€ΈμŠ€ 생성기가 ν• λ‹Ήν•œλ‹€.

μ‹œν€ΈμŠ€ μ‚¬μš©μ½”λ“œλŠ” IDENTITY μ „λž΅κ³Ό κ°™μ§€λ§Œ λ‚΄λΆ€ λ™μž‘ 방식은 λ‹€λ₯΄λ‹€.

  • 이 μ „λž΅μ€ em.persist() 호좜 μ‹œ λ¨Όμ € λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€λ₯Ό μ‚¬μš©ν•΄μ„œ μ‹λ³„μžλ₯Ό μ‘°νšŒν•œλ‹€. 그리고 μ‘°νšŒν•œ μ‹λ³„μžλ₯Ό 엔티티에 ν• λ‹Ήν•œ 후에 μ—”ν‹°ν‹°λ₯Ό μ˜μ†μ„± μ»¨ν…μŠ€νŠΈμ— μ €μž₯ν•œλ‹€.
  • 이후 νŠΈλžœμž­μ…˜μ„ μ»€λ°‹ν•΄μ„œ ν”ŒλŸ¬μ‹œκ°€ μΌμ–΄λ‚˜λ©΄ μ—”ν‹°ν‹°λ₯Ό λ°μ΄ν„°λ² μ΄μŠ€μ— μ €μž₯ν•œλ‹€.

IDENTITY μ „λž΅κ³ΌλŠ” 쑰금 λ°˜λŒ€μ˜ λŠλ‚Œ

@SequenceGenerator 속성 정리

  • name

    • μ‹λ³„μž 생성기 이름 (ν•„μˆ˜ κ°’)
  • sequenceName

    • λ°μ΄ν„°λ² μ΄μŠ€μ— λ“±λ‘λ˜μ–΄ μžˆλŠ” μ‹œν€ΈμŠ€ 이름
  • initialValue

    • DDL 생성 μ‹œμ—λ§Œ μ‚¬μš©λ¨. μ‹œν€ΈμŠ€ DDL을 생성할 λ•Œ 처음 μ‹œμž‘ν•˜λŠ” 수λ₯Ό μ§€μ •
  • allocationSize

    • μ‹œν€ΈμŠ€ ν•œ 번 ν˜ΈμΆœμ— μ¦κ°€ν•˜λŠ” 수 (μ„±λŠ₯ μ΅œμ ν™”λ₯Ό μœ„ν•΄ κΈ°λ³Έ 값이 50)
  • catalog, schema

    • λ°μ΄ν„°λ² μ΄μŠ€ catalog, schema 이름

SEQUENCE μ „λž΅κ³Ό μ΅œμ ν™”
ν•΄λ‹Ή μ „λž΅μ€ λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€λ₯Ό 톡해 μ‹λ³„μžλ₯Ό μ‘°νšŒν•˜λŠ” μΆ”κ°€ μž‘μ—…μ΄ ν•„μš”ν•΄ λ°μ΄ν„°λ² μ΄μŠ€μ™€ 2번 ν†΅μ‹ ν•œλ‹€.

  1. μ‹λ³„μžλ₯Ό κ΅¬ν•˜λ €κ³  λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€λ₯Ό μ‘°νšŒν•œλ‹€.
  2. μ‘°νšŒν•œ μ‹œν€ΈμŠ€λ₯Ό κΈ°λ³Έ ν‚€ κ°’μœΌλ‘œ μ‚¬μš©ν•΄ λ°μ΄ν„°λ² μ΄μŠ€μ— μ €μž₯ν•œλ‹€.

JPAλŠ” μ‹œν€ΈμŠ€μ— μ ‘κ·Όν•˜λŠ” 횟수λ₯Ό 쀄이기 μœ„ν•΄ allocationSize 속성을 μ‚¬μš©ν•œλ‹€. μ„€μ •ν•œ κ°’λ§ŒνΌ ν•œ λ²ˆμ— μ‹œν€ΈμŠ€ 값을 μ¦κ°€μ‹œν‚€κ³  그만큼 λ©”λͺ¨λ¦¬μ— μ‹œν€ΈμŠ€ 값을 ν• λ‹Ήν•œλ‹€.

μ΄λŸ¬ν•œ λ°©λ²•μœΌλ‘œ μ‹œν€ΈμŠ€ 값을 선점해 μ—¬λŸ¬ JVM이 λ™μ‹œμ— λ™μž‘ν•΄λ„ κΈ°λ³Έ ν‚€ 값이 μΆ©λŒν•˜μ§€ μ•ŠλŠ”λ‹€λŠ” μž₯점이 μžˆλ‹€.

➰ TABLE μ „λž΅

ν‚€ 생성 μ „μš© ν…Œμ΄λΈ”μ„ ν•˜λ‚˜ λ§Œλ“€κ³  여기에 이름과 κ°’μœΌλ‘œ μ‚¬μš©ν•  μ»¬λŸΌμ„ λ§Œλ“€μ–΄ λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€λ₯Ό ν‰λ‚΄λ‚΄λŠ” μ „λž΅μ΄λ‹€. λͺ¨λ“  λ°μ΄ν„°λ² μ΄μŠ€μ— μ μš©ν•  수 μžˆλŠ” μ „λž΅μ΄λ‹€.

create table MY_SEQUENCES ( sequence_name varchar(255) not null, next_val bigint, primary key (sequence_name) )
  • λ¨Όμ € ν‚€ μƒμ„±μš© ν…Œμ΄λΈ”μ„ μƒμ„±ν•œλ‹€.
@Entity @TableGenerator( name="BOARD_SEQ_GENERATOR", table = "MY_SEQUENCES", // λ§€ν•‘ν•  λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€ 이름 pkColumnValue = "BOARD_SEQ", allocationSize = 1) public class Member { @Id @GeneratedValue(strategy = GenerationType.TABLE, generator = "BOARD_SEQ_GENERATOR") private Long id; ... }
  • @TableGenerator 둜 ν…Œμ΄λΈ” ν‚€ 생성기λ₯Ό λ“±λ‘ν•˜κ³ , μƒμ„±ν•œ MY_SEQUENCES ν…Œμ΄λΈ”μ„ ν‚€ μƒμ„±μš© ν…Œμ΄λΈ”λ‘œ λ§€ν•‘ν•œλ‹€.
  • TABLE μ „λž΅μ„ μ„ νƒν•˜κ³ , 방금 λ“±λ‘ν•œ ν…Œμ΄λΈ” ν‚€ 생성기λ₯Ό μ§€μ •ν•œλ‹€.
  • μ‹œν€ΈμŠ€ λŒ€μ‹  ν…Œμ΄λΈ”μ„ μ‚¬μš©ν•œλ‹€λŠ” κ²ƒλ§Œ μ œμ™Έν•˜λ©΄ SEQUENCE μ „λž΅κ³Ό λ‚΄λΆ€ λ™μž‘λ°©μ‹μ΄ λ™μΌν•˜λ‹€.

@TableGenerator 속성 정리

  • name

    • μ‹λ³„μž 생성기 이름 (ν•„μˆ˜ κ°’)
  • table

    • ν‚€ 생성 ν…Œμ΄λΈ”λͺ…
  • pkColumnName

    • μ‹œν€€μŠ€ 컬럼λͺ…
  • valueColumnName

    • μ‹œν€€μŠ€ κ°’ 컬럼λͺ…
  • pkColumnValue

    • ν‚€λ‘œ μ‚¬μš©ν•  κ°’ 이름
  • initialValue

    • μ΄ˆκΈ°κ°’, λ§ˆμ§€λ§‰μœΌλ‘œ μƒμ„±λœ 값이 기쀀이고, 기본값은 0
  • allocationSize

    • μ‹œν€ΈμŠ€ ν•œ 번 ν˜ΈμΆœμ— μ¦κ°€ν•˜λŠ” 수 (μ„±λŠ₯ μ΅œμ ν™”λ₯Ό μœ„ν•΄ κΈ°λ³Έ 값이 50)
  • catalog, schema

    • λ°μ΄ν„°λ² μ΄μŠ€ catalog, schema 이름
  • uniqueConstraints

    • μœ λ‹ˆν¬ μ œμ•½ 쑰건 μ§€μ •

TABLE μ „λž΅κ³Ό μ΅œμ ν™”
값을 μ‘°νšŒν•˜λ©΄μ„œ SELECT 쿼리λ₯Ό μ‚¬μš©ν•˜κ³ , λ‹€μŒ κ°’μœΌλ‘œ μ¦κ°€μ‹œν‚€κΈ° μœ„ν•΄ UPDATE 쿼리λ₯Ό μ‚¬μš©ν•˜μ—¬ SEQUENCE μ „λž΅μ— λΉ„ν•΄ 1번 더 λ°μ΄ν„°λ² μ΄μŠ€μ™€ ν†΅μ‹ ν•œλ‹€.

μ΄λ˜ν•œ SEQUENCE μ „λž΅κ³Ό λ™μΌν•˜κ²Œ allocationSize 을 μ‚¬μš©ν•΄ μ΅œμ ν™”ν•  수 μžˆλ‹€.

➰ AUTO μ „λž΅

ν•΄λ‹Ή μ „λž΅μ€ μ„ νƒν•œ λ°μ΄ν„°λ² μ΄μŠ€ 방언에 따라 μœ„μ—μ„œ 닀룬 μ „λž΅λ“€ 쀑 ν•˜λ‚˜λ₯Ό μžλ™μœΌλ‘œ μ„ νƒν•œλ‹€. (Oracle - SEQUENCE, MySQL - IDENTITY)

@Entity public class Member { @Id @GeneratedValue(strategy = GenerationType.AUTO) private Long id; ... }
  • @GeneratedValue.strategy 의 기본값은 AUTOλ‹€. λ”°λΌμ„œ ꡳ이 λͺ…μ‹œν•˜μ§€ μ•Šμ€ 것과 λ™μΌν•˜λ‹€.
  • μž₯점은 λ°μ΄ν„°λ² μ΄μŠ€λ₯Ό 변경해도 μ½”λ“œλŠ” μˆ˜μ •ν•˜μ§€ μ•Šμ•„λ„ λœλ‹€λŠ” 점이닀. 개발 초기 λ‹¨κ³„λ‚˜ ν”„λ‘œν† νƒ€μž… 개발 μ‹œ νŽΈλ¦¬ν•˜κ²Œ μ‚¬μš©ν•  수 μžˆλ‹€.
  • SEQUENCEλ‚˜ TABLE μ „λž΅μ΄ μ„ νƒλ˜λ©΄ 이λ₯Ό μœ„ν•œ μ‹œν€ΈμŠ€λ‚˜ ν…Œμ΄λΈ”μ΄ μƒμ„±λ˜μ–΄ μžˆμ–΄μ•Ό ν•˜λŠ”λ°, μŠ€ν‚€λ§ˆ μžλ™ 생성 κΈ°λŠ₯을 μ‚¬μš©ν•œλ‹€λ©΄ Hibernateκ°€ μ•Œμ•„μ„œ 생성해쀄 것이닀.

➰ κΈ°λ³Έ ν‚€ λ§€ν•‘ 정리

μ˜μ†μ„± μ»¨ν…μŠ€νŠΈλŠ” μ—”ν‹°ν‹°λ₯Ό μ‹λ³„μž κ°’μœΌλ‘œ κ΅¬λΆ„ν•˜κΈ°μ— μ—”ν‹°ν‹°λ₯Ό μ˜μ† μƒνƒœλ‘œ λ§Œλ“€λ €λ©΄ μ‹λ³„μž 값이 λ°˜λ“œμ‹œ ν•„μš”ν•˜λ‹€. em.persist() 호좜 직후 μ‹λ³„μž ν• λ‹Ή μ „λž΅λ³„ λ°œμƒν•˜λŠ” 일을 μ •λ¦¬ν•˜λ©΄ μ•„λž˜μ™€ κ°™λ‹€.

  • 직접 ν• λ‹Ή : μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ—μ„œ 직접 μ‹λ³„μž 값을 미리 ν• λ‹Ήν•΄μ•Ό ν•œλ‹€.
  • SEQUENCE : λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€μ—μ„œ μ‹λ³„μž 값을 νšλ“ν•œ ν›„ μ˜μ†μ„± μ»¨ν…μŠ€νŠΈμ— μ €μž₯ν•œλ‹€.
  • TABLE : λ°μ΄ν„°λ² μ΄μŠ€ μ‹œν€ΈμŠ€ μƒμ„±μš© ν…Œμ΄λΈ”μ—μ„œ μ‹λ³„μž 값을 νšλ“ν•œ ν›„ μ˜μ†μ„± μ»¨ν…μŠ€νŠΈμ— μ €μž₯ν•œλ‹€.
  • IDENTITY : λ°μ΄ν„°λ² μ΄μŠ€μ— μ—”ν‹°ν‹°λ₯Ό μ €μž₯ν•΄μ„œ μ‹λ³„μž 값을 νšλ“ν•œ ν›„ μ˜μ†μ„± μ»¨ν…μŠ€νŠΈμ— μ €μž₯ν•œλ‹€.

πŸ’« ν•„λ“œμ™€ 컬럼 λ§€ν•‘ λΆ„λ₯˜

JPAκ°€ μ œκ³΅ν•˜λŠ” ν•„λ“œμ™€ 컬럼 λ§€ν•‘μš© annotation듀을 κ°„λ‹¨νžˆ μ •λ¦¬ν–ˆλ‹€.

λΆ„λ₯˜ λ§€ν•‘ annotation μ„€λͺ…
ν•„λ“œμ™€ 컬럼 λ§€ν•‘ @Column 컬럼 λ§€ν•‘
@Enumerated μžλ°”μ˜ enum νƒ€μž… λ§€ν•‘
@Temporal λ‚ μ§œ νƒ€μž… λ§€ν•‘
@Lob BLOB, CLOB νƒ€μž… λ§€ν•‘
@Transient νŠΉμ • ν•„λ“œλ₯Ό λ°μ΄ν„°λ² μ΄μŠ€μ— λ§€ν•‘ν•˜μ§€ μ•ŠμŒ
기타 @Access JPAκ°€ 엔티티에 μ ‘κ·Όν•˜λŠ” 방식 μ§€μ •

πŸ“• 좜처

@Seongukbaek
배우고 μ •λ¦¬ν•˜κ³  κ³΅μœ ν•˜λŠ” λŒ€ν•™μƒ λ°±μ„±μš±μž…λ‹ˆλ‹€ πŸ˜€